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FONT EDITOR ( page 3D ' M it b**i • t 

Allows you to edit and create hl-res character sets or "shapeTonts” to 
he used with your programs, A'/jfxr or Hi -Writer. 


imrf entertaining. In rising this slfcJk, yow 'Wft) hoiVhtfly VtiNi 
new Apple programming techniques that will her 
programs. With this in mind, all .-yy>/e Mechanic programs haw 
remained listahle and inspcctablc by normal methods, let’s get on 
with the instructions— 


BACK UP YOUR DISK: 


Unlike most commercially-made disks, Apple Mechanic is not copy 
protected ( just copyn^/j/ed ) and supports normal Apple DOS. Hither 
make a back-up with one of the copy programs on your System 
Master disk or use the I'll) program from the same disk. And store the 
original in a safe place, away from prying magnetic fields. 


FONT SPLITTER (page 42 ) 

Allows you to reduce the number of characters in any shape-font. 
SHAPE ANALYZER (page 43) 

lets you analyze shape tables and test each shape in various 
combinations of ROT, SCALH and IICOLOR. 


BOOTING: 

hooting will not Ik- necessary if you have recently hooted a normal* 
DOS disk and haven't been doing any exotic fooling around. If a 
program on A/tple Mechanic gives you a problem, try qping ‘TP" 
( return ) and re running the program, or go ahead anil boot, l or you 
newcomers out there, boot means turn your Apple off. insert jour 
disk in Drive I, close the door and turn the Apple on. Or leave the 
power on and type (usually) "PR *6" ( return ). When your drive’s red 
light goes off, you and your Apple are ready to go to work. 


XTYPER (page 34) 

lets you type shape-font characters directly onto a hi res image or 
blank screen. Hie finished image may then be saved to disk. 

HI- WRITER (page 3«) 

Allows program-control of shape-fonts. You add your own Applesoft 
commands to make "live” graphic presentations. 

HI-WRITER DEMO (page 38) 

List this to see how to make your own graphic presentations. 



A two-sided Key Chart has been included with your disk.. FOLD IT 
I.HNCiTI i WISH with the appropriate side facing up, and insert it 
behind the top row of keys on your Apple. ’Ihe Key Chart provides 
convenient labels for the "key” keys in several of the Apple M ccImoiIc 
programs and puts the instructions in front of you where they will do 
the most good. Functions that are not specified on the Key Chart will 
appear on your monitor at the appropriate times. Fold and store your 
Key Chart with your disk. (Note: Leave your disk ////folded; it’ll work 
much er that way. ) 



SHAPE TABLE DEMO (page 27) 

A demonstration of shape table commands and loading procedures. 

GREETINGS 

Our “talking heads" say hello, using most of the graphics and sound 
features on A])ple Mechanic (and then some). 

PAGE COPY (page 42) 

Three HXHC programs that move images between pages 1, 2 & 3- 
BYTE ZAP (page 49) 

A handy disk detective that lets you rewrite any byte on a disk. 

SONG SUBROUTINES (instructions on disk) 

A few little tunes and noises to liven up your programs. 

TEXT TRICKS (instructions on disk) 

Some text screen gimmicks; we couldn't resist. 

■y .to* h 

TWO-LINERS 

Spectacular winning entries from Uncle louic's famous contest.; A 

SHAPES, @1 MAGES AND ]FONTS 1 

These are binary picture files and shape tables. Carson ahdi fietno 
Shti/ws are shape tables used by the editing and dentti'pViigWrtw, III* 
res Imajtc file names are preceded by an File names that start 
with a ''1" (shift-M) are shape-fonts. You may, of course, use your 
own system for naming your own files. ~ v \ 
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Creating Shape Tables 

Shape Tables are excellent hi res animation tools. Kach "table" is 
simply a series of hi-res drawings stored in memory in the form of 
plotting and non-plotting vectors. Shapes in each shape table maybe 
called to the screen by Applesoft's DRAW and XDRAW commands. 
While being rather abstract in concept, shape tables are relatively 
easy to use. Difficulty often comes in uniting shape tables. One look 
at your Applesoft Manual will tell you why. Apple Mechanic has two 
programs that make writing shape tables a snap. To learn more about 
shape tables, their usage and structure, read How lo Use Shape Tables 
starting on page 27. 

TWO SHAPE EDITORS 

Two different shape-writing programs are on the Apple Mechanic 
disk. Shape Editor lets you create and store up to 1 2 shapes at a 
time, each one up to 48x 63 plots in size. These shapes can be 
utilized by your own Applesoft programs. Font Editor lets you 
make hi res characters or pictures that can be utilized by the Xty/K-r 
and Ill-Writer programs (both on this disk), as well as your own 
programs. 


ERROR MESSAGES 

Most error messages will relate to disk 
errors occuring when you are loading 
"I II.I: NOT FOUND" means the file you 
requested is not on the disk (or you 
spelled its name wrong) or you are 
using a disk that does not have the / 
Cursors file on it. Other error ' 
messages will lx* referenced by 1 
number. See your Hcaglc Bros 
ft'eks & Hikes Chart or Applesoft 
Manual for ONKRR error message 
aides. If you suspect you have 
made an error, remove the 
ONKRR statement from the 
beginning of the program you 
are working with. Then you can , 
list the offensive line and get a clue 
regarding what’s happening. 



THE SHAPE TABLE KEY CHART 

Use the Shape Editor side of the Key Chart that came with your Apple 
Mechanic disk. FOLD IT^and insert it behind the top row of keys on 
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your Apple. 'Hie 1-6 keys apply to the Shape Editor and Eon! Editor 
programs. Die 3 through hyphen keys are for analyzing individual 
shapes with the Shape A nalyzer program. Several Key Chart options 
are common to all three programs: 


(2) SAVE EXISTING SHAPES 

(Note*: SAVI- is not available from I he S)x tf )c Analyzer program.) 

After you have created one or more shapes with.' Shape Editor nr Emit 
Editor, your shapes are in your Apple’s memory, but not on disk. To 
save your shapes onto disk, press the 2 key. You will be asked for a 
title for the shapes you are saving. Any legal file name is o.k„ but it 
helps to add a descriptive word like "FONT’ or ‘‘SHAPES" to each 
name to keep them straight. You can always rename files later. 

You will recognize shape tables or shape-fonts in your catalog 
mainly by the title you have given them. There will also be a "U" for 
Binary to the left of the sector number. You cannot BRUN these files,, 
only BI.OAD them and then use them from your own Applesoft 
programs or A7) per or lli- Writer. 

If you find yourself accidentally in the Save Mode, hit the 
RETURN key (with no file name) to escape, or enter one of the Key 
.Chart keys (and return). 


(3) LOAD NEW SHAPES 

Select 3 to load a new shape table for editing or analyzing. The Shape 
Analyzer program can handle any Apple shape table, but Eont Editor 
and Shape Editor are very specialized. Thus, this warning: 

LOAD ONLY SHAPE TABLES MADE WITH THE EDITING 
PROGRAM YOU ARE USING. OTHERS WILL EITHER NOT 
LOAD OR NOT BE EDITABLE. 


(4) CATALOG THE DISK 

Back to the Key Chart— A 4 keypress lets you catalog the disk drive 
most recently specified; handy if you want to inspect your file names. 
You will be temporarily switched to all-text mode for. the catalog. 
Hitting any key will then return you to hi res plus texty ■.]•/ ” 

(5) DRIVE/SLOT CHANGE * ' - ! 

Sdetlng 5 lets you change the drive that will next be accessed by the 
program. Hitting RETURN defaults to the slot or drive value printed 
on the screen. Do not select a drive or slot that is not connected or 
the program will hang. 
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The SHAPE EDITOR Program 

This program lets you draw hi res shapes by plotting them on the 
screen from the keyboard. It will then temporarily store the drawings 
in your Apple’s memory’. Vtlien finished, you can save the drawings to 
disk in the form of a 1 2 shape ( maximum ) shape table for use in your 
Applesoft programs. 

qjvly shape tables made with this program can 

BE EDITED WITH THIS PROGRAM. OTHERS A£/i VLOAD, 
BUT WILL NOT BE COMPATIBLE OR EDITABLE. 


To begin, insert the Apple Mechanic disk in your drive, and type "RUN 

SHARK EDITOR". When the program title is on the screen, six Key 
Chart keys control the Editor: 

1: EDIT a Shape 
2: SAVE Existing Shapes* 

3: LOAD New Shapes* 

4: CATALOG Disk* 

5: DRIVE/SLOT Change* 

6: DISPLAY Shapes 
•Covered under Key tthart. page IS 

You can usually "escape" to this part of the program by pressing the 
ESC key. When the program title is visible, you will see all 1 2 shapes 
currently in memory on the hires screen. If you are just starting, you 
will quite likely see the Editor’s default shapes. 1 2 white dots, latch 
dot is actually a hi res slMipe in a 1 2-shape shape table. Load a set of 
shapes, like Demo S/japes. as a test (press 3. enter the name and wait 
while they load ). You can replace each of the shapes you see with any 

drawing you want to create. . 

Due to the variety of shapes you might produce, the 1 2-shape 
menu display could get a bit messy. Unusually large shapes could 
overlap or "wrap around" and partially print on the opposite side of 
the screen. No problem, however; this display is for reference only. 
You can see each shape alone by selecting Key Chart ( >pi ion 6 ( more 
later) or by hitting N now to temporarily remove the text from the 
lower screen. Any key restores the text. 

. : j 

(1) EDIT A SHAPE 

1 First you need to cluxise which shape. 1-12, you are going to create. 
Actually you are going to re-draw anti replace the shape you select. 
After pressing 1. you will see a shape on the screen, perhaps a dot if 
' ,f ; you are just starting, both DRAWN and XDRAWN (these two often 

look the same ). with its shape number below. To advance to the next 

or previous shape, use the Right or Left Arrow key. Shape # 1 will 
follow #12 and vice versa. Another way to select a shape is to type The 
shape number you want, 1-9. Shapes 10, 11 and 12 are selected for 
viewing/editing with the Zero, Colon and Hyphen key’s. You cars 
anlnr-'" hetween any shapes you choose using these twelve ,() P* roM [ 
kevs 'cample, type 4-2-4-2*4-2-). With the shape or shape 

numbev ...at you want to redraw on the screen, press RETURN. 



3X PLOTTING GRID :*A i A 

Enlarged ihape 
will appear here. r( f ^q 

Actual-size shape *ii 

will appear here. . j, 0 

Now you see two rectangles on the screen and 
nvulL- of dots Notice that you can move the cursor left & right with 
TA™w keys and up & down with the A and Z keys. You will be 
l A^Tshape in a magnified version (3 times actual size) by 
moving' this cursor inside the larger rectangle. Simultaneously you 
will see the shape plotted in actual size in the smaller rectangle. Mme 
the cursor, if necessary, to its starting point ( allowing room for your 

“""S ;'m! ™r«,r < -LI, a d,,, in .he middle 

HvindJs to "MOVE" and back. Draw your shape with the A. /. and 
Arrow kevs Your drawing will consist of a number of vectors 
^Se^lnSetSe. .ttdtU,. long). All vector, plotted or no, 

Untilsstapcslo the a*c.rfihcphHllnR»rHl.JH*M 
- . . # #irl | fM nog si*n unite vectors. \ou will encounter some 

program listing. Change it if you want. 

T^r^nwtfof shapes as they are being drawn, use X as a back- 
space” key. You cannot erase pre-plot dots with this feature. 


U is^best to plot each shape as efficiently as possible using the fewest 
number of vectors. If you want, you can preplot your draw mg on the 
streen without regard inefficiency and then trace over sketch for 

your final drawinge ,l//tr you have selected the ^ 

positioned the cursor, and before you h i M I N. selee. P. I No 
Liu can draw on the screen with a serie-s of dots, lbe actual size 
Priwine in the smaller rectangle will appear as it normally would, o 

create your Miape# 


• . n ..fRcUfuv Don't ulvc il too much thought. An “ineRUienily 

•One more noie on imuincy o<m » g Apple ma>tx* a 


(I) IMPRINT 

Alter you have selected the shape you want to edit, you may imprint 
any existing shape on the drawing screen by hitting I, selecting the 
shape to be imprinted (with the Arrow keys or 1-9, zero, colon or 
hyphen ), and hitting RHTURN. Imprinting is done if you want to 
create a shape similar to another ( for animation, perhaps ) by tracing 
!f! t)vef the imprint. 'Ibe imprint is repositionable using the A, 7. and 
Arrow keys. Repositioning is done to center the imprint in the 
rectangles or to align the imprint with your In-progress drawing. 

To keej) the imprinted image on the screen and start or continue 
plotting your shape, hit RliTURN. To erase the imprint, hit liSC. 'Hie 
imprint will lx* erased from the small ( actual size ) rectangle, regard- 
less of which option you select. « 

The imprint in the larger rectangle is XDRAWN with SCALIi=3. 
You will notice that enlarged shapes seem to lx* a bit inaccurate. Finds 
of lines go too far or are bent at their ends, and dots appear as short 
lines. Ibis is just the nature of scaled-up shapes. With a little practice, 
you’ll get used to them and be able to use them as models for 
drawing. If the drawing you are creating is already in progress on the 
screen, you will see the imprint in reverse where it crosses your 
picture. In the actual-size drawing, the imprint and your drawing 
could actually cancel each other out temporarily. 

PLOTTING TIPS 


Lines that cross each other can lx* confusing at first. A plotting vector 
(solid cursor) will normally plot. Hut a vector that plots over an 
already-plotted point (as in the center of a figure-8) will iniplot the 


2 PLOTS 



point. You may ignore this problem if you are going to mainly DRAW 
your shapes from your programs, but if you are going to XDRAW or 
animate them, the flaw will show. To move tlx* plotting cursor 
nit/jont changing the drawing under it, use the SPACK HAR to select 
the dotted (non-plotting) cursor. And remember, you can always 
correct mistakes by backing up with the X key. 


Positioning the cursor before plotting is usually necessary only 
on larg e sba/tes that might approach the limits of the drawing rcetan- 

* gle. If you are planning a shape that is going to go off to the right, for 
example, you should position the cursor near the left edge of the 

• rectangle hefmv plotting, giving you room to draw. 'Ibe cursor 
■starting position will remain the same until you change it. 

The list point of a shape is where the next shape will start if your 
program uses a command like "XDRAW I: XDRAW 2". In this exam- 
ple;,, Shape * 2 will be drawn on the screen starting where Shape * I 
stopjx*d. If you will always be using plotting coordinates In your 
progr -sin "XDRAW I AT 1 0,10: XDRAW 2 AT 1 0.99", you don't 
need meemed where your shapes end. 




You may use less than 12 shapes by simply ignoring -the ones 
you don’t want. The default dot shapes take up only two bytes apiece. 

To create shape tables with more than 12 shapes, use the 
Font Editor program, which allows 95 shapes. X |. ;f }^ 

(RETURN) FINISHING A SHAPE 

Usually, you won’t care where your shape ends. Just draw ^ntil it 
looks the way you want (especially in the actual-si/e version ). and hit 
RETURN. W hen asked, “READY TO WRITE SHARK INTO TABLE?”, 
answer Y. If you had answered N, you would have been allowed to 
continue drawing. If you want to start over, answer N and then ESC 
Now your drawing will be “written” into the shape table. Hie 
more complex your shape, the more time this will take. Ihe main 
title will reappear when writing is complete. Create as many shape’s 
as you like, from I to 1 2. Just select Option 1, and select the shape 
you want to redraw next. 

(6) DISPLAY EACH SHAPE 

Selecting Key Chart Option 6 when the main title is visible will let 
you view each shape individually, DRAWN and XDRAWN. Use the 
Arrow keys to view different shapes, and RKTl IRN to see all twelve. 

How to Use Shape Tables 

Ibis section covers the basics of using shape tables. The commands 
are simple and the results are amazing! List the Shape Table Demo to 
learn much much more. And above all. experiment! (let in there 
and make some mistakes (heck. I can't teach you anything). 

LOADING YOUR SHAPE TABLE 

First, set ROT & SCAM; to their minimum values, 0 and I. Then 
decide where in your Apple's memory to load your shape table. For 
now, let's pick location 2*5, ()(X); it's a nice round number and out of 
the way of other goings-on. Set a variable in your program (for 
example, SI I ) equal to 25000 and load your shape table like so— 

10 ROT* 0s SCALE* 1 

20 SH « 25000s D* = CHR* (4) 

30 PRINT D$, "BLOAD SHAPES, A M jSH 

A shape table is a Binary file, so it must be HI.OADed (but never 
HRUN). To play it safe, always tell the shape table where to load by 
specifying the fixation as part of the HI.OAI) command. In the 
example above, you could have used ",A25000" for the, same 
results. While programming, you won't want to wait while your 
shapes load every time you run the program, so ( after you hayi; run it 
once) put a temporary "RFM" in front of your HI.()AD<#*tatement. 

On page -15, there is a discussion regarding More Room for 
Ili-Rcs h'ograms. If you load your Applesoft program, Vs suggested 
there, at fixation 2 (576 (16000), you will need to load ypiir shape 
table elsewhere or one will erase the other. Izxation 20 18 ( SHOO), 
the normal pmgmm fixation, would be appropriate and allow you 
the most space. If you like round numlxrs, set nil to 3000. 


h«lu«r 
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SETTING THE SHAPE TABLE POINTER 

Now you need to to tell your Apple where your shape table is • 
(loeation 25,000) in memory. In jour program, do two pokes— 

40 POKE 232, SH - INT <SH / 256) * 256 
,£$ )Xh P0KE 233, INT (SH / 256) 

n 'AsSdWiing you have set SI I equal to 25000, these two pokes put that 
"number into the S/xipe Table hdnter at memory locations 232 & 
23.5. If you run the above program now, that pointer will he set. If you 
forge! to do the two pokes in your next shape table program, the 
program might work fine, because the pointer stays set, even surviv- 
ing the often fatal "NEW" and “FP" commands. Hut tomorrow your 
Apple won’t know where your shape table is stored. When you turn 
off your Apple or re-hoot, the Shape Table pointer will “point" to the 
wrong place. The DRAW command will probably produce random 
scrihblings, much as if you hadn’t even loaded your shape table. So, 
always include the two pokes at the beginning of your shape table 
programs. 

USING MORE THAN ONE SHAPE TABLE 

To alternate between shape tables, simply re-poke a new location 
into the shape table pointer at 232-233 each time you change. 

HCOLOR 

To DRAW a shape, you need to specify a color by setting HCOLOR 
equal to a number, 0-7. If you don’t, your shape might be drawn In 
HCOLOR 0 (black) and you won’t see it. Here are Apple’s hi-res 
colors.— 

HCOLOR=0 or 4: Black 
HCOLOR=l: Green 
HCOLOR=2: Violet 
HCOLOR=3 or 7: White 
HCOLOR=5: Orange 
HCOLOR=6: Blue 

DRAW AND XDRAW 

DRAW means just that, draw a shape from a shape table. Use the 
command like this— 

99 DRAW 3 AT 100,901 REM (AT X,Y) 

r Th.e first number after DRAW is the number, 1-255, of the shape to be 
;4rawn, The next two numbers are the horizontal and vertical hi-res 
coordinates of the starting point of the shape. If you get an PII.LEGAL 
QUANTITY error, you have either attempted to draw outside of the 
screen’s limits or you have specified a shape number larger than the 
number of shapes available. 

The XDRAW command works like DRAW, but ignores HCOL- 
OR and plots each dot of your shape in the opposite color of the dot 
that is being plotted over. XDRAW is handy for animation because 
you can l “ a shape travel over and be seen against multi-colored 
backgro. 


BLACK (0/4) is opposite WHITE (3/7) 
GREEN (1) is opposite VIOLET (2) 
ORANGE (5) 1» opposite BLUE (6) 


HI RES COORDINATES ‘fl !L 

To tell a shape where to appear, specify the coordinates (horizontal, 
vertical) of the shape’s starting point. Don’t specify a start Ictf^n 
outside of the screen limits, or your program will crash. I lere are the 
hl-res limits for Apple hi-res— 

Horizontal: 0 to 279 

Vertical: 0 to 191 

Vertical with 4 text lines: 0 to 159 


DRAWING WITHOUT COORDINATES: After your first shape is 
drawn, you don’t need to specify coordinates for the next DRAW or 
XDRAW. but you probably will want to. Hach successive shape drawn 
without coordinates (as in “XDRAW 3: XDRAW I : XDRAW 9" ) will 
begin at llx> /xdnt where the previous shape stopfwd. Eventually, 
Using consecutive commands like this, shapes will usually wrap 
around" and begin plotting on the opposite side of the screen. 

SCALE 

You can enlarge a shape by setting SCALE equal to a number, 2-255 or 
zero. A SCAIT of zero is equivalent to a SCALE of 256. Scaled up 
shapes are of limited use because the plotting vectors arc lengthened 
only and spread apart as they are enlarged. They often end strangely- 
bent at right angles, depending on how the shape was created.Tn 
short, scaled-up shapes usually just don’t look right. 

ROT 

You can rotate a shape by setting ROT before you draw- 

ROT=0: Normal 

ROT=l6: Rotated 90° Clockwise 
ROT=32: Rotated 180”(upside down) 

ROT=48: Rotated 270’CIockwise 


ROT values between the above only apply when SCALE is set larger 
than minimum ( I ). ROT values greater than M simply repeat the 
cycle until ROT=255. 


MOVING A SHAPE 

There is more than one way to move a shape. Basically you have (o 
draw the shape, erase it, and redraw it in a new position. This 
XDRAW example moves a shape across the screen— 

100 FOR X « 0 TO 279 .1 j-Vmi* 

110 XDRAW 5 AT X,100s REM DRAW SHAPE s ift 
115 XDRAW 5 AT X,100i REM ERASE SHAPE 
120 NEXT X ,!<’ 

With DRAW, you erase the shape by re-DRAWing iMn the back- 
ground color— 


100 FOR X ■ 0 TO 279 

!!J i S'SJ" 3 ‘ DRAW 5 AT X.100< REM DRAW 
01 DRflW 3 flT *.»«•• REM ERASE 

{ (f tJvVfSDfW-iU with adding different delay loop* between drawing and 
moSjafW for example add these lines- ** ° 

V f ‘FOR I - 1 TO 50* NEXT 



OTHER HI RES MANIPULATIONS 


HGR— Clears I>age 1 to black & reveals it for drawing. 

HGR2— Clears Page 2 to black & reveals it for drawing 
HCOLOR=X: IIPLOT 0,0: 

CALL 62454— Clears hi res in HCOI.OK X 

Tlie following “switches" do not clear the screen, but ivneal what- 
trer is currently on the page I or 2 text, hi res or lo res screens: 
POKE 49252,0— View graphics screen* (hi- or lo res) 

POKE 49235,0— View text screen 
POKE 49234,0- View hill graphics screen (hi- or lo-res) 
POKE 49235,0- View graphics plus 4 text lines* (VTAI1 21-24) 
POKE 49236,0- View Page I * (hi-res. lo-res or text) 

POKE 49237,0- View Page 2 
POKE 49238,0— View lo-res 
POKE 49239,0- View hi res* 

•Auiomutically sol hy IKiK 

POKE 230,32— Allows drawing on page ! 

POKE 230,64— Allows drawing on page 2 

POKE 230,96- Allows drawing on page 3 ( not directly viewable ) 

?!)«*; P*v» disregard which page is currently being viewed. IXriiinu other 

<K ' JMon - Vl produce unpredictable, often disastrous results. Try IX >KJ ! 
: ' nd ll " M " w hpl* tiling, lor example, lie prepared to lose your pmgram and 
re boot il you try other numbers. 1 ^ 

PRINT PEEK(228) — Prints HCOLOR code (see l\vks & Pokes) 
PRINT PEEK(231 )- Prints current SCAM* value ' 

PRINT PEEK(249)— Prints current ROT value 
CALL 62923— Stores last plotted coordinates at locations 224-226 
PEEK/ *6)— VERTICAL position during last CAM. 62923 
PEER, PEEK(225)*256— Horizontal during CAM. 62923 


,J-t LSI 

The FONT EDITOR Program;; 

111 is program is similar in concept to Shape lulilor. blit specialized to 
create shape table character sets or fonts of t ype. Hadr' shapt^font" 
consists of 95 hi res characters that can be printed onto tftlft&ti&h by- 
adding Applesoft commands to the ///-IV W/7:7?prograni. (W^iPcan 
t)pe the characters directly onto a hi-res picture or blank screen by 
running the X'/YPliK program. Shape-fonts may be redesigned or 
used as-is without editing. Any character may be redrawn as you like 
(as pictures, symbols or whatever), as long as it (its within the 
maximum dimensions specified by the Editor. 


ONLY SHA PE-FONTS MADE WITH THIS PROGRAM CAN 
BE EDITED WITH THIS PROGRAM. OTHERS MA V LOAD 
Bl/T WILL NOT BE COMPATIBLE OR EDITABLE. 


SHAPE FONTS vs. OTHER FONTS: 

In your encounters with other disks, you will undoubtedly come 
across other hi-res type fonts. Apple Mechanic's shape table type is 
unique, however, and incompatible with most other Apple type. Ihat 
is, you can't use the same programs to display or edit shape-fonts as 
you do to display or edit other kinds of hi res type. 

ADVANTAGES: Shape-fonts have the distinct advantage of being 
pro/torlionally spaced. An “I", for example, doesn't need to occupy 
the same screen space as a "W”. Word-spacing and the distance 
between lines of type is adjustable. And type doesn't have to be any 
certain height; it can range between 3 and 16 dots high, exactly as 
you designed it, and be positioned anyieheiv on the hi res screen 
without regard to \iahs or litahs. Shape-font type can be A 'J)K4\\'N 
t«)o, so that each character is automatically printed in the opposite of 
the background color. And shape-font characters are fast— Pont 
lulilor creates characters that will be drawn from upper-left to 
lower-right, ending adjacent to the left edge of the next character to 
be printed. Ilierefore coordinates do not need to be specified when 
displaying each character-shape. 

DISADVANTAGES: Shape fonts take up more memory and disk 
space than other hi-res fonts you may have seen, usually around IH 
sectors for large-height fonts and 7 for small-height fonts (hill 95. 
character fonts). You will find fonts on Apple Computer's DOS Tool 
Kit. for example, that only occupy 5 sectors. Hie difference is irt flit* 
flexibility and attractiveness of the typefaces and resultine^reen 
presentations. ■ C 

it )oofl-'ji 

LARGE FONTS vs. SMALL FONTS 

All shape-fonts are classified as Urge or Small. Small fonts correspond' 
approximately in height to Apple's normal text characters. All font 
names on the /\J>p!e Mechanic disk are preceded by a "]" (shift-M )? 
All are large-height fonts, except those with the word "small" in tlfitff 
names. Another way to recognize font size is by catafe-sector size— 
Full 96-character large fonts’ tend to Ik* 16-20 sc. ! small 


fonts 6- 10 sectors. Large-font characters may he up to M x 1 6 hi res 
Small characters are limited to 7 x 8. The difference is 
of characters when printed with AVjperand Hi- Writer 
\ou may, of course, create small characters in a large font but nm 
, J w CC 'Sr ia ^' < l )U know how shape tables are constructed you might 
largc fonTs W SCC ° nd byte issct to 1 forsmaI1 fonuand 2 foJ 

RUNNING THE PROGRAM 

To begin insert the same Key Chart you used for Shape Editor. Boot 
he disk, it necessary, and RUN FONT EDITOR”. When the program 
title is on the screen, six keys control the program: P ^ 

1: EDIT a Character 
2: SAVE Existing Shapes* 

3: LOAD New Shapes* 

4: CATALOG Disk* 

5: DRJVE/SLOT Change* 

6 : DISPLAY (Type) Shapes 
•Covered under Kiy Chart , page 23 

Y«)u can usually escape to this part of the program by pressing the 
op k Sn?2-5 hC Sba/W T “ blC Kty °*' rt notcs on P**^ A for details 

^ h n yo " mn ,ht * Program, you will see the plotting grid and 
die characters currently in memory. If you are just starting you 
might see the Editor’s default "characters". 95 white dots. Each do™ 

wVth a i ust a "ffw rh/ ,e n a ‘ahlc. If you wanted a font 

with /list .1 few characters (only numbers, for example) you could 

start with this dot "font” and add only your special characters, or you 

can use the /out S/ditter program (page 42). More likely vou will 

THE PLOTTING GRID 

After you have loaded a font with Key Chart Option 3. the character 
set will be displayed. To the left you will see a rectangular plotting 
grid for drawing characters at 10 times actual size. Hie grid’s siz? 
depends on whether a large ( 14 x 16) or small (7 x 8) font wa.s 

fh S . t ^ Ctnt y <>:ldcd ! lK * <Jonc<J lines on the grid have no function 
other than to serve as visual guides for lower case, descenders and so 
on. Their use is up to you. w 

(1) EDITING CHARACTERS 

AAerj.you have loaded a font (Key Chart Option 3), select the 
character to be edited by pressing the 1 key. A striped flashing cursor 
will . appear on one of the characters. To move the cursor to the 
character you want to edit or replace, use the Arrows and A & Z 
keys. Be.ow the character set, you will see the ASCII value of the key 
that will eventually type the character ( for example, KEY "A” ASCII 
>5),TheSPA(.E character, ASCII 32, is the only one not accessible 
from th ditor. Hit RETURN when the cursor is on the character you 


Now you have three options: , . . , , 

(I) GRID IMPRINT: Prints the selected character xW-mtitfa, 
up on the grid; good for making minor changes sinc , e'W(^W^<» 
character will already be drawn for you. K 

(E) ERASE/REDRAW: Temporarily erases the 
screen so you can completely redraw it 

purposes only and does not affect the final shape K 

& 

Annl 1 , llt sha P c >'« ,u ,1a ve plotted is only temporary- it isn’t in the 

cajjsszix zvfr draw , a chirmr 

Eft.* '" c do ' f " m ' 

<«), DISPLAY (TYPE) SHAPES 

bt-twet-n Kt'S ESC ■“’"'W**' 

( «CK5t Z,'° T an in '^; 


charactrr.frjL^jljic 
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bnB <Thc XTYPER Program 

’ ^V^^iThis program may be used to type onto the Page One hl-res screen 
n .(»• ! s ’using up to three shape-fonts at a time. You may want, for instance, to 
label a diagram or graph that you have plotted with another program. 
After you have added type to your picture ( or to a blank screen ), you 
can save the entire image to disk. To start, type "RUN XTYPHR" and 
be sure your disk has at lexst one large or small shape-font on it 
including ever)’ font you intend to use. 

THE MAIN MENU 

Running Xtypir or selecting ctrl-R while typing displays the main 
menu and lets you load fonts from the disk, clear the hi-res screen, 
load & save hi-res images, and quit the program. Exit the menu and 
begin typing by pressing RKTURN. 

(1, 2 & 3) LOADING FONTS 

You may load up to three large or small shape-fonts into memory in 
any order you wish. Select 1, 2 or 3 from the menu and enter the 
name of the font. 'Ilie font will then lx* loaded into memory showing 
you its start location after the font name (for example, “BLOAD 
FONTNAMR, A 1 8880"). You don’t need to be concerned with this 
number. You may replace any font any time you wish from the main 
menu. If you tv-load Font I or Font 2, any higher-numbered font in 
memory will automatically be reloaded at a new fixation. Therefore 
all three of the fonts you are using need to be on the same disk. If you 
attempt to load Font 2 or Font 3 when there is a lower number 
unused, your font number will be changed to the lowest unused 
number. 

(X) CLEAR HI-RES SCREEN 

Always select X to clear the screen if you have no Image loaded on 
hi res Page One. Otherwise you could encounter a "snowy" back- 
ground ( an uncleared screen ) on which to type. If this happens, type 
ctrl-R, X, Y and RETURN (just follow the screen prompts). 

(L) LOAD HI-RES PICTURE 

Select L to load a hi-res picture from your disk. This could be a chart, 
a graph, a picture of your dog, or any hi-res image to which you want 
to add hi res type. 

(S) SAVE EXISTING PICTURE 

After you have typed on a cleared screen or on your picture, select S 
from the main menu to save the entire image on disk. If you don’t 
want a previous picture to be erased, don’t use the same name when 
re-saving it. You will recognize a picture file in your catalog with its 
• i FT* name preceded by a "B" for Binary and (usually) an "03-1" for 34 
,v*\i\7, ■:! > sectors. It helps if you name picture files with the word "picture" or 
i "rjii'jir. similar identification in the title. We have used an "(5)’’ before zt/i/j/e 
-.r .’-jk y Mechanic picture file names. 

T - ’-tg: Be sure your shape-font files are locked. If you acciden- 
ta.. :r a font name when saving a hl-res image, the font will be 


erased from the disk if the font is not locked! You may lock and 
unlock files by first selecting C to catalog. ' “ ~ 

Noli.*: To see any hi res picture on Pap.* One when you arc not running I'program, i)pc 
HGR ( return ) and BLOAD PICTURE, AS2000 ( return ), where 1 IMLTliRiristhe 
name of the intap* you want to see. / . j ^ j, | 

(C) CATALOG DISK (and Lock/Unlock) 

Select C to catalog from the main menu. You will need to do this to 
check the names of fonts or hi res pictures. You will he given the 
option of locking and unlocking Hies after the catalog. 

(Q) QUIT PROGRAM 

Selecting Q from the main menu lets you quit Xt)jnr. Wlien you quit, 
you will see the message "GOTO 2000 TO CONTINUI:". If you were 
to type “RUN" instead of "GOTO 2000”, you would need to reload 
your fonts into memory'. 

(RETURN) BEGIN TYPING 

Hit RKTURN to begin or continue typing on the hi-res screen. You 
must have loaded at least one shape font to type. 


TVPING WITH XTYPER 

After you have loaded at least one font from the main menu and hit 
RKTURN, you will see a flashing rectangular cursor on the screen that 
corresponds to the approximate height of the current font and the 
current case, upper or lower. Now you can type on thcscreen’or use 
one of tile control commands below. You will get best results if you 
type in white (any size) or in color (large fonts only) on the BLACK 
background areas of the screen (see Color Change below). 

Ike fallowing commands appear on your Key Clxirh 

(RETURN) CARRIAGE RETURN 

Hitting RETURN while typing puts the cursor at the left margin on 
the next line down. To change the vertical distance the cursor will 
move, see Leading Notes below. If you continue typing to the right 
margin, your words will "wrap around" without dropping to the next 
line. With ,Y ()/x*r you must hit RKTURN just as you would on a 
typewriter. 

(ESC) UPPER & LOWER CASE 

Ilie ESC key will toggle between upper & lower case. The cursor 
height will change accordingly. Since shape-fonts can vary in charac- 
ter height, the height of the cursor might not exactly match. 

(ctrl-P, ctrl-T & ctrl-Q) NON-KEY CHARACTERS 

Three Apple characters have no corresponding keys! With Xty/Hr, 
ctr I-P types a left-square bracket* (the right - square bracket* is 
typed with shift-M as usual ). Ctrl-T types the underscore*, and 
ctrl-Q types the backslash.* ^ 

*Or the character programmed fiw that key. 


MOVING THE CURSOR: 

commands move » lie c urso r on the screen without typinu or 
erasing, 'ton must hold the CTRL key down while you move the 

'r ,>P r d U >OU havc a sp:,rc you may also 

list the REPTU) for long distance moves. Hie left & Right Arrows 

wV,', ,T“m ] movc i hc cursor ,cft and right approximately one 
( hat m tei . Move your fingers three keys to the left and use ctrl-K& 
ctrl-L to move the cursor left and right one plot. Ctrl-A & ctrl-Z 
move the cursor up and down approximately one type line. And one 

"• C * r, ' S ^ c * r| -X •<> "'O'C- llu.- cursor ..p OowS 
oni plot. I)ut to the varying sizes of shape-font characters, the cursor 
height will not always exactly match the height of the characters 
hung typed. The top of the caps cursor, however, will usually align 
with the lop oj i/x' letter about to be typed or erased. ^ " 

ERASING: 

Proportion;! 1 type has many advantages. One d/sadranlave is the 
difficulty of making corrections. Xlyjter gives you several ways to 
erase ( and t)ping a s/xue over a character is not one of them ) First 
the top of the cursor nmst he (dialled vertically with the top of a 
capital letter on the line of type on which you wish to make an 
erasure. C.ot it? Now, here are your options for erasing: 

(ctrLB) BACKSPACE/ERASE: Place the left of your cursor at the 
right of the character you want erased. Now use ctrl-B as a back- 
space/erase key. A vertical black’ line will be drawn at the left edge of 

!.,^r U , rsor ' ; ,nd ,l,c clirsor wil1 move one plot to the left. Use the 
Rl. I key if you want (press CTRI, I) and REFT), and continue 
ctrl-H-ing until you are through erasing. 


(*•^*’1*®) CHARACTER ERASE: This method works only with 
white type on a black background— Align your cursor vertically as 
described above, and position its left edge so it loaches any part of 
the character to be erased. Now type ctrl-E and your Apple will 
erase the character ( in black). Stencil Ponl characters will often only 
be partially erased with ctrl-E due to their split design. 

WIPE OUT: I yping ctrl-W will erase an entire line of type 
in black’ from the top of the caps cursor down. 


OVERTYPING: Another way to erase a character is to place the 
cursor over it, aligning the lop and left edges, change the typing eolor 
(drl-O) to the color of the background, and tyntover the characters 
to be e^sed using the same characters and the same font. 

•See Ik me (jnlnr next puj*e. 


(ctrl-F) FONT CHANGE: 

Selecting ctrl-F while typing will allow you select a new typing 

o.nt y ( ,u may not. of course, select a font number that has not been 
loaded into memory. 

(Ctrl O) COLOR CHANGE: 

Selecting Ctrl O while typing will allow you to se lect a new typing 
color. Due to Apple s hardware configuration, typing in colors mher 
than white or black might present some surprises- Characters with 
h.n verticals could look distorted, especially on a non color moni- 

i uihe Ant C1;,rat ;r S arC !! nrcad;,Nc *" colors other than black 
or white. And colored type or lines on a color background will tend 

wire is re illv 4 P r ° duc 'V ' Malr-stepped” edges. Apple’s hi res hard- 
CROI INn v/w dcM f’[ 1ctJ ° Nll Pr K,r( colors on a BLACK BACK- 
or i i ollack'/ Ct y ° U ch<K)SC al,crna tc color *1 (white) 

(ctrl-G) GRID: 

.S'llinfn^rU WhilC K"* wiM displa >’ a 4 x 4 K rid on >™r draw, 
ng I luting ctrhC again will erase the grid. Ilie purpose of the grid is 

to display the edges of the hi-res screen and to give some visual refer- 
cncc for aligning and centering type. 

Warning: Don t type over the grid if you are going to erase the grid 

(ctrl-R) RETURN TO MAIN MENU: 

Selecting ctrl-R while typing will display the main menu, so you can 
save or load a picture, load a new font, clear the screen, catalog the 
disk or quit the program. ^ mt 

LEADING NOTES: 

leading (pronounced "hiM/ng") is the vertical distance between 
lines of type. Super normally puts two lines of leading between 
characters, large and small. If you type a lower case ’V a d c lc-ft 
margin, hit RETURN, and type an upper case ”E’\ you will Je a 

Vr 'V i)f ! wn P ,ols hctwccn the characters. To change this 
default value of 2 to any other value, change the first non-RFM 
program line in A* t)per. Ilie variables l.l)( I ). I.l)(2) and I I)( A ) 
r T resent the leading for the three fonts in memory If you want/or 

nv.kc- P nyWr,' 11 , i :ad ! n }* whcn >' ou hit RH I1IRN with Font 2. 
make *•!)( 2 )— i. Note: Apples normal text uses a corresponding 

tailing ofzem. putting one vertical space between characters, how 
f 1 /’ “‘ u,st ‘ ,h e standard text font has no descenders (pans of 
letters like p. ,, and y that go below the ba.se line), 

DEFAULT ERASE COLOR: /as n . . 

Just In case you an. doing a lot of typing on non-black hickMiidtf } 

Kih^'iu T^ ,hC Sccond non ’ R, ‘ :M P r °Rram line in Xty/nr. Ihc> 
Variable HC. Is the erase color used by ctrl-ll and ctr^V ’ r -’ 


IT 


Apple //e Notes 


Due to the Apple //e's new top-row key- 
arrangement , there are some changes... 


ALIGN YOUR KEYBOARD CHART LEFT/RIGHT 
WITH THE 1 THROUGH 0 KEYS, AND THE 
CHART'S COMMANDS WILL BE CORRECT. 


1 234567890 :-RES 

1234567890- = DEL 


The Byte Zap WRITE-TO-DISK key is the 
EQUAL-key (keychart reads o.k.). 

The Shape Analyzer Program now uses the 
HYPHEN, EQUAL and DELETE keys instead o-f 
the Colon, Hyphen and Reset keys 
(keychart reads o.k.). 


AND... 

I-f a program is responding oddly, check 
to see that your CAPS-LQCK key is DOWN. 


GENERAL NOTES: 


* SINCE THE APPLE MECHANIC DISK IS 

0 X FULL, YOU MAY WANT TO USE FID (ON 
YOUR SYSTEM MASTER DISK) TO SPLIT IT 
INTO 2 OR MORE DISKS, THUS PREVENTING 
DISK FULL ERRORS WHEN SAVING FILES. 

* THE FLUSH-LEFT TITLES AND BLANK FILE 
NAMES IN THE CATALOG WERE MADE WITH 
BYTE ZAP AND WILL TRANSFER WITH FID. 

* IF YOU SUSPECT AN ERROR IN A PROGRAM, 
REMOVE THE ONERR GOTO STATEMENT 

FROM THE LISTING AND RE-RUN THE 
PROGRAM FOR A REPORT ON ERROR TYPE 
AND ERROR LINE NUMBER. 

* TU MAKE A HARD COPY PRINTOUT OF A 
HI -RES IMAGE, YOU NEED TWO THINGS— 

(SEE YOUR APPLE DEALER.) 

1. A PRINTER WITH HI-RES CAPABILITIES. 

2. HI -RES DUMP SOFTWARE THAT IS 
COMPATIBLE WITH YOUR PRINTER. 


BYTE ZAP NOTES: 


* THE GREETING (HELLO) PROGRAM NAME ON 
APPLE MECHANIC IS APPLE MECHANIC. 

TO CHANGE IT, SEE ."AGE "i. 

* THE DISK VOLUME CATALOG HEADING HAS 
BEEN CHANGED TO BEAGLE BROS. T Q 

CHANGE IT, SEE PAGE 58. 

* T 0 MAKE THE VOLUME NUMBER PRINT OR NOT 
PRINT WHEN YOU CATALOG, YOU CAN MAKE A 
CHANGE ON TRACK 1, SECTOR 12 (*0C): 


BYTE 

NUMBER: 


192 ($C0), 

193 ($C1), 

194 ($C2), 


PRINT 

VALUE: 


32 ($20) 
66 ($42) 
174 ($AE) 


NO-PRINT 

VALUE: 


234 ($EA) 
234 ($EA) 
234 ($EA) 


* REMEMBER, DOS CHANGES WILL ONLY BE IN 
EFFECT AFTER BOOTING THE CHANGED DISK. 


NEW FEATURES: 


* TO RE-READ THE CURRENT TRACK & SECTOR 
WITH BYTE 2AP, PRESS THE SPACE BAR. 


* A THIRD PAGE COPY PROGRAM (SEE PAGE 
42) HAS BEEN ADDED TO THE DISK. 

EXEC PAGE COPY 1=3 MOVES PG.3 TO PG.l. 


EXEC PAGE COPY 1=3, R4 MOVES PG.l TO 3. 


SEE PAGE 30 (POKE 230, ETC.) IF YOU ARE 
UNFAMILIAR WITH HI -RES PAGE 3. 


* THE XTYPER PROGRAM NOW SUPPORTS TWO 
DISK DRIVES. 


REMEMBER TO FOLD YOUR KEY CHART 
LENGTHWISE AND INSERT IT BEHIND 
THE TOP ROW OF KEYS ON YOUR APPLE. 



Apple Mechanic 
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XTYPER 

(Direct typing of Shape Fonts) 

FUNCTIONS- 
Return: Carriage Return 
Esc: Upper/Lower Case 
Ctrl-F: Font Change 
Ctrl-G: Grid On/Oft 
Ctrl-O: Color Change 
Ctrl-R: Return to Main Menu 

ERASING— 

Ctrl-B: Backspace/Erase 
Ctrl-E: Character Erase (B&W) 
Ctrl-W: Wipe Out a Line 

CURSOR MOVES- 
Arrows: Left/Right apx. 1 character 
Ctrl-K/L Lett/Right 1 hi-res plot 
Ctrl-A/Z: Up/Down apx. 1 line 
Ctrl-S/X: Up/ Down 1 hi-res plot 


HI-WRITER 

(Program-controlled Shape-Fonts) 

OOSUB 100: Execute 
A$: Copy to be Printed 
FT: Current Font (1*3) 

FT3$: New Font 3 to Load 
VT: Vertical Position (1-24) 

HT: Horizontal Position (1-40) 

IN: Inverse (1-Yes, 0-No)* 

CT: Auto-Center (1-Yes, 0-No)* 
HC: Type HCOLOR (0-7) 

CL: Clear Screen HCOLOR (0-7) 
RT: ROT Value/16 (0-3)* 

POKE TXT.0: Partial Text 
POKE FULL,0: Full Graphics 
TEXT: Full Text 
POKE HIRES, 0: Hi-Res 

'Reset to zero after every GOSUB 100 


—Shape Editor/Font Editor— 




EDIT SAVE LOAD CATALOG DRIVE DISP 
Shape Shapes Shapes Disk Change Shai 



—Shape Analyzer— 


DRAW 

Arrows/A/Z: ±9 
K/L/S/X: ±1 

MOVE 

Arrows: ±16 
A/Z: ±1 
Return: Rot=0 

ROT 

Arrows: ±1 

A/Z: ±20 
Return: Scale=1 

SCALE 

Arrows: ±1 

H: Shape Color 

B: Background 
Return: B&W 

HCOLOR 

VECTOR 

XDRAW 

Shape 

Test 

Test 

Test 

Analysis 
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